Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Locating a Movie's Tracks and Media Structures

GetMovieIndTrack

The GetMovieIndTrack function allows your application to determine the track identifier of a track given the track's index value. The index value identifies the track among all current tracks in a movie. Index values range from 1 to the number of tracks in the movie.

pascal Track GetMovieIndTrack (Movie theMovie, long index);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

index

Specifies the index value of the track for this operation.

DESCRIPTION

The GetMovieIndTrack function returns the track identifier that is appropriate to the specified track. If the function cannot locate the track, it sets this returned value to nil.

ERROR CODES

badTrackIndex	-2028	This track index value is not valid
invalidMovie	-2010	This movie is corrupted or invalid

SEE ALSO

You can determine the number of tracks in a movie by calling the GetMovieTrackCount function, which is described in the previous section.